Contexto global

BeginAttachingAddIn

Variante de sintaxis: Por identificador

Sintaxis:

BeginAttachingAddIn(<CallbackDescription>, <ObjectId>)

Parámetros:

Tipo: CallbackDescription.
Contiene la descripción del procedimiento que se llamará al completarse con los siguientes parámetros:

• <Connected> – el resultado de la conexión, Tipo: Boolean.
• <AdditionalParameters> – valor especificado cuando se creó el objeto CallbackDescription.

Tipo: String.
Identificador del objeto complemento como un ProgID (Identificador programático) del registro de Windows (por ejemplo, “AddIn.Scanner”).

Descripción de la variante del método:

El componente debe ser desarrollado utilizando la tecnología COM y registrado en el registro de Windows.
Estos componentes son compatibles con los componentes de 1C:Enterprise 7.7.
¡Atención! La variante del método no funciona en el servidor ni en la conexión externa.

Variante de sintaxis: Por ubicación

Sintaxis:

BeginAttachingAddIn(<CallbackDescription>, <Location>, <Name>, <Type>, <AttachmentType>)

Parámetros:

Tipo: CallbackDescription.
Contiene la descripción del procedimiento que se llamará al completarse con los siguientes parámetros:

• <Connected> – el resultado de la conexión, Tipo: Boolean.
• <AdditionalParameters> – valor especificado cuando se creó el objeto CallbackDescription.

Tipo: String.
La ubicación del componente externo.
Se puede utilizar lo siguiente como ubicación:

• ruta al archivo del componente externo en el sistema de archivos (no disponible en el cliente web); no un archivo ZIP;
• nombre completo de la plantilla que almacena datos binarios o un archivo ZIP;
• URL del componente externo almacenado como datos binarios o un archivo ZIP en un formato similar a GetURL.

Tipo: String.
Un nombre simbólico del componente externo adjunto.
El nombre debe cumplir con las convenciones de nomenclatura de script de 1C:Enterprise.

Tipo: AddInType.
El tipo del complemento adjunto.
No se utiliza si el componente está archivado en ZIP.

Tipo: AddInConnectionType.
Tipo de conexión del complemento.

Descripción de la variante del método:

El componente puede ser desarrollado utilizando cualquier tecnología.
¡Atención! La variante del método no funciona en el servidor ni en la conexión externa.

Descripción:

Inicia la conexión del objeto complemento a 1C:Enterprise.
Los componentes externos pueden almacenarse en la base de datos de información o en plantillas de configuración como un archivo ZIP o como datos binarios.
Cuando se utiliza el cliente ligero y el cliente web, el complemento debe estar preinstalado.

Disponibilidad:

Cliente ligero, cliente web, cliente móvil, cliente grueso, aplicación móvil (cliente).

Nota:

Los complementos se pueden implementar utilizando la API nativa o la tecnología COM.
El cliente web solo puede utilizar los complementos en la base de datos de información comprimidos en un archivo ZIP.
El cliente ligero solo puede utilizar los complementos en la base de datos de información empaquetados en un archivo ZIP y los complementos ubicados en el sistema de archivos.
El cliente grueso puede utilizar cualquier opción de almacenamiento de complementos. En este caso, si el complemento está instalado utilizando el método InstallAddIn, se utilizará el complemento instalado y, si no está instalado, se recibirá el complemento al conectarse.
El servidor puede utilizar todos los complementos. El complemento se almacena en caché por sesión del servidor.

Ejemplo:

&AtClient Procedure Command(Command)     Attach(True); EndProcedure &AtClient  Procedure Attach(InstallIfNotAttached) Export     BeginAddInAttachment(         New NotificationDetails(             “AfterAttachment”,             ThisObject,             InstallIfNotAttached),         “CommonTemplate.AddIn”,         “AddIn”); EndProcedure &AtClient Procedure AfterAttachment(Attached, InstallIfNotAttached) Export     If Attached Then         // Complemento adjunto     ElsIf InstallIfNotAttached Then         BeginAddInInstallation(             New NotificationDetails(                 “Attach”,                 ThisObject,                 False),             “CommonTemplate.AddIn”);     Else         // No se puede instalar o adjuntar         // complemento     EndIf;          EndProcedure

Véase también:

Contexto global, método LoadAddIn
Contexto global, método BeginInstallAddIn

Disponible desde:

Disponible desde la versión 8.3.6.

Descripción cambiada en la versión 8.3.22.

---